Working with Tasks

Right-clicking a task opens a context-menu that displays the available functions; these depend on the type of task (whether it is a Workflow, a Schedule, a Job, etc.), of its status and of whether they are historical tasks (and therefore deactivated) or not.

This table provides an overview with short descriptions of all available functions. They are listed in alphabetical order to help you find them easily. In additions, links to the related topics in this help are provided.

Icon

Function Description See...
Activator Executions Opens the list of historical data of the instances that trigger the execution of tasks.

Execution Data Overview

Activator Executions
  Apply modifications

Available for workflows in the Workflow Monitor. If you want to change settings in a running workflow you must first stop its execution; for this purpose you right-click on the workflow and select Modify. Then you make your changes. To apply them you select this option.

Applies your changes to the running workflow and sets it back to active.

Workflow Definition — Overview

Monitoring Workflows

  Cancel Cancels the task. Child tasks are not canceled.  
  Cancel (Recursive)

Cancels the task and its child tasks.

 
Child Executions Opens the historical data of tasks which execution is triggered by another object

Execution Data Overview

Child Executions
Comments

Opens a dialog where you can enter additional information on the task.

Tasks that contain comments display the comment icon in the RunID column.

Entering Comments
Create Forecast Forecasts calculate the expected execution times and the estimated runtime of executable objects and tasks. Forecasts and Auto-Forecasts
Deactivate

Removes an ended task from the list.

One of the setting of the executable object definitions is what should happen with tasks after their execution, whether they should be deactivated or not. The following options are available:

  • Never
  • Always
  • After error-free execution
  • After error-free restart
  • Deactivate after x minutes

See Automatic Deactivation Section for details on this.

If, according to these settings, ended tasks are still active and therefore displayed on the list and you want to get rid of them, you can do so with this command.

The only exception are tasks for which the Never option has been selected. The Deactivate function does not affect them.

Deactivating workflows includes all its subordinate tasks.

 
  Deactivate (Forced)

Available for tasks that are workflows.

It deactivates the workflow and its child workflows (if any) even if they still contain active tasks.

This option always overrules the Automatic Deactivation settings (see above) in the object definition, even if they have been set to Never deactivate tasks.

A workflow's rollback function will fail for workflows that have already been deactivated via this option.

 
Edit Opens the object in the Process Assembly perspective and allows you to modify its definition, provided you have the necessary privileges. Defining Objects
Edit in New Window Opens the object in the Process Assembly perspective in a new browser window and allows you to modify its definition, provided you have the necessary privileges. Defining Objects
Executions Opens the list of executions (historical data) of the selected task

Execution Data Overview

Executions
  Filter Limits the activity list according to specified filter criteria. Filtering Tasks
  Go Immediately

Starts processing a task immediately. Tasks that have a Waiting status start as well. Child tasks are not affected.

Executing Objects Overview
  Go (Recursive)

Starts processing a task immediately. This option is available for tasks with start type RECURSIVE that have a Waiting status.

It also starts child tasks.

Executing Objects Overview
Ignore Preconditions This command continues a task when it is in a waiting status due to Preconditions that have been specified in the workflow properties. The actions/conditions are ignored and skipped. Preconditions, Postconditions, Conditions
Ignore Queue Limit

For tasks that are waiting to start because of missing queue slots (Waiting for Queue slot).

It starts the task immediately.

Queue Object (QUEUE)
Ignore Sync Conditions

Sync objects contain definitions on status, conditions and actions that are combined to specify the order in which tasks will be executed.

Tasks can be in a waiting status due to Sync definitions. This option ignores the conditions defined in the Sync object assigned to the task and starts it.

Monitoring Sync Objects

Sync Object (SYNC)

  Modify

Available for workflows in the Workflow Monitor. If you want to change settings in a running workflow you must first stop its execution; for this purpose you right-click on the workflow and select this option.

To apply your changes you must then select Apply modifications.

Workflow Definition — Overview

Monitoring Workflows

  Modify Execution Available for Period containers (C_PERIOD tasks)  
  Modify Parent Properties Allows you to change the maximum number of parallel tasks allowed for the task or to suspend task processing.

Modifying the Properties of Job Groups

Modifying the Properties of Agent Groups

  Modify Priority

Opens the dialog where you can change the priority of the task.

This option is available for tasks with a status between 1500 and 1799 (see System Return Codes of Executable Objects).

Automation Engine Priority

  Modify Properties

Available for Job Groups and Agent Groups. It opens a dialog where you can modify the maximum number of parallel tasks allowed for the task or to suspend task processing.

Modifying the Properties of Job Groups

Modifying the Properties of Agent Groups

  Modify Status Manually

Allows you to change the status of a task.

This option is available only if your user definitions has the necessary rights.

Modifying the Status of a Task Manually
  Modify Task Allows you to change parameters of tasks that have been started with the Execute once option (not Immediately)

Executing Objects Once

Modifying Tasks at Runtime

  Open Agent Group Monitor

Available for tasks that are being processed by an Agent Group.

It opens the list of tasks that are processed by the Agent Group.

Monitoring Job Groups

Agent Groups (HOSTG)

  Open Monitor

Opens the monitor of the selected task in a new page. Available only for running tasks that have a monitor view of their own (for example, workflows, schedules, groups, etc.).

The monitor provides information on the progress of the task and functions to modify the current execution.

Monitoring Job Groups

Monitoring Agent Groups

Monitoring Workflows

Monitoring Schedules

Monitoring Sync Objects

  Open Parent Monitor Opens the monitor of the task's parent object. It provides information on the progress of the task and functions to modify the current execution.

Monitoring Job Groups

Monitoring Agent Groups

Monitoring Workflows

Monitoring Schedules

Monitoring Sync Objects

Open Report Opens the report of the selected execution (RunID) Reports Overview
  Open Sync Monitor Opens the list of tasks affected by one or more Sync objects Monitoring SYNC Objects
  Open User Input Dialog

Opens the dialog where you can enter the values that the task need to complete its processing.

Entering Data at Runtime
Parent Executions

For tasks with a parent task; it opens the list of past executions of the parent task.

 

 

Execution Data Overview

Parent Executions
Properties

Opens a pane at the bottom half of the page where you can see and modify the properties of the tasks included in the selected container.

These changes are valid only for that particular execution (that is, for the execution with that runID).

For Workflows:

Modifying the Properties of Tasks at Runtime

For Schedules:

Modifying the Properties of Tasks at Runtime

  Quit

Ends a long-running activity.

Only available for long-running, recurring activities. For example, these activities execute a particular process repeatedly within a particular interval (event). They must be manually ended by the user.

 
  Recalculate next start time

Available for Schedules.

Schedules and tasks within Schedules can have calendars assigned to them.

If calendars or calendar events are changed in the Schedule or in any of its tasks, you must select this option if you want the monitor to display the next start time according to the new calendar definitions.

Schedule Objects (JSCH)

Schedule Monitor Overview

  Refresh Loads the current data for the task.  
Release Manually

Before being actually executed, tasks go through the following phases: Activation, Generation and Transfer. See Stages of Job Processing for details on this.

If so configured, it may be necessary to modify the generated JCL of jobs before executing them. In these cases, tasks are activated, their scripts are generated and, if applicable, transfers are carried out. The tasks, however, are not executed and their status is Waiting for manual release.

You select this option to execute them.

 
  Reload definition at period turnaround

Available for Schedules.

If selected, changes done to the Schedule definition in the Process Assembly perspective will be applied with the next period turnaround.

A tick next to this option indicates that this function is activated.

Schedule Objects (JSCH)

Monitoring Schedules

  Remote Restart Allows you to restart SAP child jobs Executing Objects Overview
  Remove Available for jobs in Registered status.  
Reset Task

Available for Schedules. This sets the task back to its previous status.

Schedule Objects (JSCH)

Monitoring Schedules

Restart Tasks that have already been executed can be restarted and you can define the required Executing Options.

Executing Objects Overview

Restarting File Transfers

  Remote Restart

Available for RemoteTaskManager jobs.

Restarts SAP jobs.

Remote Task Manager Object (JOBQ)

Executing Remote Task Manager Objects

Rollback Task Processes a rollback on the task. This function is available for ended workflows only.

Rollback Page

Processing a Rollback

Rollback to this Task

This rolls back all tasks from the workflow's end to the selected task (which is also included).

This is only possible for ended tasks (successful or aborted).

Rollback Page

Processing a Rollback

Run Workflow Task

This command starts the workflow task immediately.

Only available for workflow tasks that have not yet started.

 
Search for use Opens the list of objects in which a particular object or task is being used Searching for Object Dependencies
Set active Sets back the workflow to active.  
Set Inactive

The task is not processed within the workflow but skipped.

This command is available for tasks that have not yet started (status: Waiting for predecessor).

 
Set Breakpoint

Causes the workflow to stops at this task.

This is available for tasks that have not yet started (status: Waiting for predecessor).

The status of the workflow changes to blocked.

To continue processing it you must open the Workflow monitor and delete the breakpoint manually

Workflow Definition — Overview

General Tab

Show Definition

Opens the workflow in the Process Assembly perspective, where you can edit it.

Requires access to the Process Assembly perspective.

Workflow Definition — Overview
  Suspend This command pauses the processing of the task and is available for long-running tasks (such as Schedules and Events) and Workflows.  
  Suspend (Recursive) This command pauses the processing of the task and all its subordinate tasks. Only long-running tasks and Workflows are paused.  
  Take Over Task Allows you to take the ownership of a task.  
Unblock task

This removes the task's blocking condition. Task and workflow processing continue.

This is only available for blocked tasks.